Setting up the Template Generator

Introduction

The template generator is supplied with Websydian and is installed with the Websydian installation script. In order to enable the Template Generator and allow you to run it from within the Plex IDE you need to perform a number of steps.

You have the choice of a Windows C++ or a Java version of the Template Generator and configuration depends on the choice of Windows or Java.

• Setting up Windows C++ based Template Generator
• Setting up Java based Template Generator

Setting up Windows C++ based Template Generator

Copy required objects and folders to your GEN folder

A number of objects are required to be in your GEN\Release folder in order for the Template generator to run. These objects are supplied with the Websydian installation and is placed in the sub folder named TemplateGenerator\PlexX.X\GEN

The folder structure of the Template Generator supplied with Websydian

1. Copy all files and folders from the GEN folder of the Websydian installation to the GEN folder of your local model.

Ensure correct settings for the Template generator in the Websydian.ini file

The Websydian template generator uses a configuration file named Websydian.ini which is located in your GEN\Release folder.

1. Using notepad open the file named Websydian.ini located in your GEN\Release folder of your local model, locate the TemplateGenerator section
   [TemplateGenerator]
   GeneratedTemplatePath=..\templates\
   xmltemplatefolder=..\xml\
   
   TemplateGenerator=c:\Websydian\Websydian v6.5\TemplateGenerator\TemplateGen.cmd
   MetaTemplatePath=c:\Websydian\Websydian v6.5\TemplateGenerator\metatemplates\
   
   [WebSourceHTM]
   sourcedir=..\templates\
2. Check the following folders and file references are valid

TemplateGenerator

This is a reference by path and file name to the script used in order to execute the actual template generation.

MetaTemplatePath

The template generator requires that you specify the location of the meta templates that will be used during the template generation.

GeneratedTemplatePath

This is the location where the final templates are created by the template generator.

xmltemplatefolder

This is where the template generator will save the XML files that hold information about your model and is used by the template generator to create the final templates.

sourcedir

This is the location where the final templates are created by the template generator, used by the _DocumentTemplateGenerator.

Ensure correct path to the Template Generator runtime in the Ob600RC.ini file

In order for the CA Plex IDE to execute the Websydian template generator you need to add the path of the Websydian template generator runtime to the Ob600RC.ini file located in your GEN\Release folder.

1. Using notepad open the Ob600RC.ini file located in your GEN\Release folder of your local model and do a search for path=
   [International Settings]
   Uppercase Input=False
   Uppercase EBCDIC Input=True
   PNL directory path=.;c:\Websydian\TemplateGenerator\Plex6.1\wincruntime
   
   [Settings]
   PreviewPages=2
   ; If IniFileReadOnly is True and this file is really read-only then updates to this file will not be allowed
   IniFileReadOnly=False
   DLL directory path=.;c:\Websydian\TemplateGenerator\Plex6.1\wincruntime
2. Ensure that the PNL directory path and DLL directory path includes to correct location of the wincruntime folder available with the Websydian template generator.

Multiple folders are separated by a ; (semicolon).

Setting up the Java based Template Generator

Copy required files and folders to your GEN folder

A number of files and folders are required to be in your GEN folder in order for the Template generator to run. These objects are supplied with the Websydian installation and is placed in the sub folder named TemplateGenerator\Plex\sddsdGEN

The folder structure of the Template Generator supplied with Websydian

1. Copy all files and folders from the GEN folder of the Websydian installation to your GEN folder of your local model.

Ensure correct settings for the Template generator in the Websydian.prop file

The Websydian template generator uses a configuration file named Websydian.prop which is located in your GEN\bld folder.

1. Using notepad open the file named Websydian.prop located in your GEN\bld folder of your local model

   GeneratedTemplatePath=[DriveAndLocationOfYourLocalModel]/GEN/templates/

   xmltemplatefolder=[DriveAndLocationOfYourLocalModel]/GEN/xml/

   TemplateGenerator=c:/Websydian/Websydian v6.5/TemplateGenerator/TemplateGen.cmd

   MetaTemplatePath=c:/Websydian/Websydian v6.5/TemplateGenerator/metatemplates

2. Check the following folders and file references are valid:

TemplateGenerator

This is a reference by path and file name to the script used in order to execute the actual template generation.

MetaTemplatePath

The template generator requires that you specify the location of the meta templates that will be used during the template generation.

GeneratedTemplatePath

This is the location where the final templates are created by the template generator.

xmltemplatefolder

This is where the template generator will save the XML files that hold information about your model and is used by the template generator to create the final templates.

Ensure you include the correct jar files in your Generate and Build - System Properties

In order for you to run the _CreateTemplates function from within your Plex generate and build window you need to reference a number of jar files from your Generate and Build Options - System Properties.

The System Properties where you need to add specific jar files

Open the Generate and Build Options select the System Definitions and your system then go to the Java Build section.

Make sure that you reference the following jar files in either the "JDK classes" or "User classes" text field.

• WsydTmpl.jar
• xalan.jar
• xercesImpl.jar
• WsydXML11.jar
• WsydUtil.jar
• WsydDwa21.jar

These files are supplied with Websydian in the folder named \Development\PlexX.X\jars.

If based on a default location the final text string to add would look like this for Plex v6.1 (for readability a line break have been added after the ; if you copy and paste this make sure to remove the line break before pasting into Plex)